<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>运行时配置</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="memcache.installation.html">« 安装</a></li>
      <li style="float: right;"><a href="memcache.resources.html">资源类型 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="memcache.setup.html">安装/配置</a></li>
    <li>运行时配置</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="memcache.ini" class="section">
 <h2 class="title">运行时配置</h2>
 <p class="simpara">
这些函数的行为受 <var class="filename">php.ini</var> 中的设置影响。
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>Memcache配置选项</strong></caption>
   
    <thead>
     <tr>
      <th>名字</th>
      <th>默认</th>
      <th>可修改范围</th>
      <th>更新日志</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="memcache.ini.html#ini.memcache.allow-failover" class="link">memcache.allow_failover</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since memcache 2.0.2.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.max-failover-attempts" class="link">memcache.max_failover_attempts</a></td>
      <td>&quot;20&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since memcache 2.1.0.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.chunk-size" class="link">memcache.chunk_size</a></td>
      <td>&quot;8192&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since memcache 2.0.2.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.default-port" class="link">memcache.default_port</a></td>
      <td>&quot;11211&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since memcache 2.0.2.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.hash-strategy" class="link">memcache.hash_strategy</a></td>
      <td>&quot;standard&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since memcache 2.2.0.</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.hash-function" class="link">memcache.hash_function</a></td>
      <td>&quot;crc32&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Available since memcache 2.2.0.</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.save-handler" class="link">session.save_handler</a></td>
      <td>&quot;files&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Supported since memcache 2.1.2</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.save-path" class="link">session.save_path</a></td>
      <td>&quot;&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>Supported since memcache 2.1.2</td>
     </tr>

      <tr>
      <td><a href="memcache.ini.html#ini.memcache.protocol" class="link">memcache.protocol</a></td>
      <td>ascii</td>
      <td>&gt;PHP_INI_ALL</td>
      <td>Supported since memcache 3.0.0</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.redundancy" class="link">memcache.redundancy</a></td>
      <td>1</td>
      <td>&gt;PHP_INI_ALL</td>
      <td>Supported since memcache 3.0.0</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.session-redundancy" class="link">memcache.session_redundancy</a></td>
      <td>2</td>
      <td>&gt;PHP_INI_ALL</td>
      <td>Supported since memcache 3.0.0</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.compress-threshold" class="link">memcache.compress_threshold</a></td>
      <td>20000</td>
      <td>&gt;PHP_INI_ALL</td>
      <td>Supported since memcache 3.0.3</td>
     </tr>

     <tr>
      <td><a href="memcache.ini.html#ini.memcache.lock-timeout" class="link">memcache.lock_timeout</a></td>
      <td>15</td>
      <td>&gt;PHP_INI_ALL</td>
      <td>Supported since memcache 3.0.4</td>
     </tr>

    </tbody>
   
  </table>

  有关 PHP_INI_* 样式的更多详情与定义，见 <a href="configuration.changes.modes.html" class="xref">配置可被设定范围</a>。
 </p>

<p class="para">这是配置指令的简短说明。</p>

<p class="para">
 <dl>
  
  
   <dt id="ini.memcache.allow-failover">
    <code class="parameter">memcache.allow_failover</code>
    <span class="type">bool</span>
   </dt>

   <dd>

    <p class="para">
     是否在发生错误时（对用户）透明的转移到其他服务器。
    </p>
   </dd>

  
  
  
   <dt id="ini.memcache.max-failover-attempts">
    <code class="parameter">memcache.max_failover_attempts</code>
    <span class="type">int</span>
   </dt>

   <dd>

    <p class="para">
    定义在写入和获取数据时最多尝试的服务器次数（即：故障转移最大尝试数），仅和
    memcache.allow_failover结合使用。
    </p>
   </dd>

  
  
  
   <dt id="ini.memcache.chunk-size">
    <code class="parameter">memcache.chunk_size</code>
    <span class="type">int</span>
   </dt>

   <dd>

    <p class="para">
    数据传输块大小，这个值越小网络I/O次数越多，如果发现莫名的速度降低， 可以尝试将此值调至32768。
    </p>
   </dd>

  
  
  
   <dt id="ini.memcache.default-port">
    <code class="parameter">memcache.default_port</code>
    <span class="type">string</span>
   </dt>

   <dd>

    <p class="para">
    在尝试连接memcache的时候如果没有单独指定端口默认使用的TCP端口号。
    </p>
   </dd>

  

  
   <dt id="ini.memcache.hash-strategy">
    <code class="parameter">memcache.hash_strategy</code>
    <span class="type">string</span>
   </dt>

   <dd>

    <p class="para">
    控制key到服务器的映射（分布式）策略。值 
     <code class="literal">consistent</code>允许服务器增减而不会（大量）导致健的重新映射
     （译注：参见http://tech.idv2.com/2008/07/24/memcached-004/），设置为
     <code class="literal">standard</code>则使用余数方式进行key的映射。
    </p>
   </dd>

  
  
  
   <dt id="ini.memcache.hash-function">
    <code class="parameter">memcache.hash_function</code>
    <span class="type">string</span>
   </dt>

   <dd>

    <p class="para">
    控制在key-server映射时使用哪个hash函数<code class="literal">crc32</code> 
    标明使用标准CRC32进行hash，<code class="literal">fnv</code>则说明使用FNV-1a。
    </p>
   </dd>

  

  
   <dt id="ini.memcache.session-handler">
    <code class="parameter">session.save_handler</code>
    <span class="type">string</span>
   </dt>

   <dd>

    <p class="para">
    当值为<code class="literal">memcache</code>时标记使用memcache作为session处理器。
    </p>
   </dd>

  

  
   <dt id="ini.memcache.save-path">
    <code class="parameter">session.save_path</code>
    <span class="type">string</span>
   </dt>

   <dd>

    <p class="para">
    定义一个逗号分割的用于session存储的服务器url列表，例如：
     <code class="literal">&quot;tcp://host1:11211, tcp://host2:11211&quot;</code>.
    </p>
    <p class="para">
    每个url可以包含参数，这些参数于方法<span class="function"><a href="memcache.addserver.html" class="function">Memcache::addServer()</a></span>的参数相同。比如： 
     <code class="literal">&quot;tcp://host1:11211?persistent=1&amp;weight=1&amp;timeout=1&amp;retry_interval=15&quot;</code>
    </p>
   </dd>

  

  
   <dt id="ini.memcache.protocol">
    <code class="parameter">memcache.protocol</code>
    <span class="type">string</span>
   </dt>

   <dd>

    <p class="para">
     
    </p>
   </dd>

  

  
   <dt id="ini.memcache.redundancy">
    <code class="parameter">memcache.redundancy</code>
    <span class="type">int</span>
   </dt>

   <dd>

    <p class="para">
     
    </p>
   </dd>

  

  
   <dt id="ini.memcache.session-redundancy">
    <code class="parameter">memcache.session_redundancy</code>
    <span class="type">int</span>
   </dt>

   <dd>

    <p class="para">
     
    </p>
   </dd>

  

  
   <dt id="ini.memcache.compress-threshold">
    <code class="parameter">memcache.compress_threshold</code>
    <span class="type">int</span>
   </dt>

   <dd>

    <p class="para">
     
    </p>
   </dd>

  

  
   <dt id="ini.memcache.lock-timeout">
    <code class="parameter">memcache.lock_timeout</code>
    <span class="type">int</span>
   </dt>

   <dd>

    <p class="para">
     
    </p>
   </dd>

  
 </dl>

</p>
</div></div></div></body></html>